home *** CD-ROM | disk | FTP | other *** search
/ Ian & Stuart's Australian Mac: Free / Another Ian and Stuart's Free (Australia).iso / Internet / Utilities / PPP Utilities / PPPReport1.0b3 / PPPReport Read me < prev   
Text File  |  1994-12-17  |  8KB  |  96 lines

  1. PPPReport 1.0b3
  2. User Documentation
  3.  
  4. Introduction
  5.  
  6. Have you ever wished for some way to log  your Internet usage? PPPReport was designed to do just that. It's not that you don't trust your Internet providers, just that it's nice to know that you are getting what you pay for. Until now, there has been no easy way for Macintosh users to keep track of their on-line time.
  7.  
  8.  
  9. System Requirements
  10.  
  11. System 7, MacTCP, MacPPP and of course, Internet access. Note that PPPReport will not work with a slip connection.
  12.  
  13. Installation
  14.  
  15. Drag the file named "PPPReport" onto your System Folder. PPPReport must be placed in the Control Panels folder to work correctly. You must restart your Macintosh to activate PPPReport.
  16.  
  17. Configuration
  18.  
  19. "Log duration": Default is not checked. If checked, PPPReport will generate the total time on each port. An example is shown below, the first line of data has the "Log duration" unchecked, the second line has the "Log duration" checked.
  20.  
  21.                     0            12/16/1994            15:18:38            12/16/1994            15:18:48
  22.                     0            12/16/1994            15:11:28            12/16/1994            15:16:24            0:04:56
  23.  
  24. As you can see in the second line of data, PPPReport has figured out how long the connection was open for. Your probably thinking to yourself, what is the "Log duration" option for? Well, I'll tell you. For those of you who run your Mac with the clock in the 12 hour mode, if you check the "Log duration" checkbox, PPPReport will add a 12 to the hour part of your total time. See below.
  25.  
  26.                     0            12/15/1994            1:27:33 PM            12/15/1994            1:28:33 PM            12:01:00 AM
  27.  
  28.  I tried to code around this but it is difficult to do (maybe someday). You may find it easier to run your Mac with the 24 hour clock, and have PPPReport tally each connection than to go with the 12 hour clock and work with the data in a spreadsheet or database. It is up to you.
  29.                     
  30. "Don't duplicate ports": Default is checked. If multiple connections are open simultaneously on the same port, PPPReport saves only the total time on that port instead of an itemized list of each individual connection.
  31.  
  32. "Log all ports": Default is checked. If checked PPPReport will log all open ports. If this is not checked, you can enter the ports to log (only numbers are accepted in the list and must be separated by non-numeric characters, a space works just fine). Port "0" is always logged by PPPReport (port "0" is not used on the Internet and is used to save the total time of your connection). If you simply want to log your total time on the Internet, uncheck the "Log all ports". Additionally, port 255 is reserved by PPPReport for logging connections on "all other ports". I'll give you an example; if you type "119 255" in the list, PPPReport will log connections on port 119 and connections on all other ports will be logged on 255. You might want to play around with this to see just what it does, and check the data that PPPReport generates to set this to your liking. This could be useful if your provider has different charges for various connections. Say that your provider charges for all connections but news, you could keep track of that with this feature. If you just pay a flat hourly or monthly fee, don't even bother or worry about this feature.
  33.  
  34. Where...  button: You can set where PPPReport will save your connection data. Clicking on it gives you the standard Macintosh dialog box asking where you want your PPPReport data saved. The default is in your Preferences folder inside the active System Folder. The default name of the saved file is PPPReport data but you can change this as well if you so desire.
  35.  
  36. Creator... button: You can select the application that you wish to view your PPPReport data with. The same Macintosh dialog box comes up here as well, but you can select your favorite program. The default is BBEdit.
  37.  
  38. PPPReport in Action
  39.  
  40. As soon as a connection is established with your provider, PPPReport will write in a text file, "PPPReport data" in your Preferences folder (or where or what you set this to). 
  41.  
  42.                 - Port number (see Appendix A for a list of these ports).
  43.                 - Date and time when the port is open.
  44.                 - Date and time when the port is closed (or connection closed).
  45.                 - Time of connection with each port (if you check the "Log duration").
  46.  
  47. Each field is separated with a tab  and each record with a return character. You can import or paste this data to a database or spreadsheet program for your use. It can be tricky to get some spreadsheets to generate usable totals from this data, but I've found that Excel works quite well with the data that PPPReport generates.
  48.  
  49. Legal Mumbo Jumbo
  50.  
  51. Although PPPReport is freeware, it is not "public domain". It is copyrighted, and the copyright will be enforced whenever appropriate; therefore: 
  52.  
  53. •PPPReport can only be distributed in its entirety: the control panel PPPReport and this read me.
  54.  
  55. •    PPPReport cannot be sold, either by itself or in combination with any other product, without my express written permission.
  56.  
  57. •    If you're a user group which is publishing a CD-ROM or floppy collection, you may include PPPReport without restriction, save that the original package is included. Contact me for up-to-date versions and information.
  58.  
  59. •    If you’re a hard disk company which distributes PD, shareware, and freeware on your disk drives, you’re welcome to distribute PPPReport. Contact me for up-to-date versions and information.
  60.  
  61. •    Commercial publishers and distributors of CD-ROM software collections  may  not distribute PPPReport on CD-ROM  without  my express  written permission.
  62.  
  63. •    PPPReport may be posted on an information service which charges its users for general connection time and downloading, but it may NOT be posted to an information service which will charge for the specific right to download PPPReport, without my express written permission.
  64.  
  65. •    PPPReport may be given away as a support utility for a package which is itself to be given away. People who need to  distribute PPPReport as a support utility should contact me for up-to-date versions and information. 
  66.  
  67. Eric de la Musse makes no warranty, express or implied, with respect to the software or documentation including (but not limited to) implied warranties of merchantability and fitness for a particular purpose. In no event will Eric de la Musse be liable for loss of profits or goodwill or other indirect, special, incidental, or consequential damages resulting from any defect in the software or documentation, even if advised of the possibility of such damages. 
  68.  
  69. PPPReport is copyright ©1994 by Eric de la Musse. All rights reserved. Questions? Problems? Praise? Suggestions?  Address correspondence to:
  70.  
  71. Eric de la Musse
  72. edlm10@calvanet.calvacom.fr
  73.  
  74. A special thanks to Peter Atkins (patkins@wimsey.com) for helping me with this
  75. documentation, as the English language is not amongst my strong points.
  76.  
  77. Appendix A 
  78.  
  79. A short list of current port numbers:
  80.  
  81.             Numbers                                                Services
  82.             
  83.                         20                                                                             FTP-DATA                           File Transfer [Default Data]
  84.                         21                                                                       FTP                                                                    File Transfer [Control]
  85.                         23                                                                       TELNET                                         Telnet
  86.                         25                                                                       SMTP                                                    Simple Mail Transfer
  87.                         70                                                                                            Gopher
  88.                         79                                                                       FINGER                                          Finger
  89.                         80                                                                                         WWW                                                                    World Wide Web
  90.                         109                                                               POP2                                                            Post Office Protocol - Version 2
  91.                110                                                                     POP3                                                            Post Office Protocol - Version 3
  92.                         119                                                               NNTP                                                      Network News Transfer Protocol
  93.  
  94. A full list is available in RFC 1340.
  95.  
  96.